package com.ruoyi.system.service;

import java.util.List;
import com.ruoyi.system.domain.Topic;

/**
 * 题目Service接口
 *
 * @author ltr
 * @date 2024-10-22
 */
public interface ITopicService
{
    /**
     * 查询题目
     *
     * @param topicId 题目主键
     * @return 题目
     */
    public Topic selectTopicByTopicId(Long topicId);

    /**
     * 查询题目列表
     *
     * @param topic 题目
     * @return 题目集合
     */
    public List<Topic> selectTopicList(Topic topic);

    /**
     * 查询当前教师的题目列表
     *
     * @param teacherId 教师ID
     * @return 题目集合
     */
    public List<Topic> selectTopicListByTeacherId(Long teacherId);

    /**
     * 查询已审核通过的题目列表（学生端使用）
     *
     * @param topic 题目查询条件
     * @return 题目集合
     */
    public List<Topic> selectApprovedTopicList(Topic topic);

    /**
     * 新增题目
     *
     * @param topic 题目
     * @return 结果
     */
    public int insertTopic(Topic topic);

    /**
     * 修改题目
     *
     * @param topic 题目
     * @return 结果
     */
    public int updateTopic(Topic topic);

    /**
     * 批量删除题目
     *
     * @param topicIds 需要删除的题目主键集合
     * @return 结果
     */
    public int deleteTopicByTopicIds(Long[] topicIds);

    /**
     * 删除题目信息
     *
     * @param topicId 题目主键
     * @return 结果
     */
    public int deleteTopicByTopicId(Long topicId);

    /**
     * 审批通过题目
     *
     * @param topicId 题目ID
     * @param auditBy 审核人
     * @return 结果
     */
    public int approveTopic(Long topicId, String auditBy);

    /**
     * 审批拒绝题目
     *
     * @param topicId 题目ID
     * @param auditOpinion 拒绝理由
     * @param auditBy 审核人
     * @return 结果
     */
    public int rejectTopic(Long topicId, String auditOpinion, String auditBy);

    /**
     * 更新题目的已录取学生数
     *
     * @param topicId 题目ID
     * @param increment 增量（+1或-1）
     * @return 结果
     */
    public int updateTopicCurrentStudents(Long topicId, Integer increment);

    /**
     * 检查题目是否属于指定教师
     *
     * @param topicId 题目ID
     * @param teacherId 教师ID
     * @return 是否拥有
     */
    public boolean checkTopicOwner(Long topicId, Long teacherId);

    /**
     * 检查题目是否可以删除（没有学生报名）
     *
     * @param topicId 题目ID
     * @return 是否可删除
     */
    public boolean checkTopicCanDelete(Long topicId);

    /**
     * 提交题目修改申请（针对已通过审核的题目）
     *
     * @param topic 包含修改内容的题目对象
     * @return 结果
     */
    public int submitTopicModification(Topic topic);
}